home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / sortsrc.arc / readme < prev    next >
Text File  |  1989-03-06  |  2KB  |  53 lines
  1.  
  2.                               Sort
  3.                               ----
  4.  
  5.  
  6.    The sort utility here presented is comparable to the Unix sort utility;
  7.    even most of the flags are the same. Sorting is done in core as much as
  8.    possible; else a \tmp directory (or a user supplied one) is used for
  9.    creation of temporary files.
  10.  
  11.    Two speedups have been done that might affect portability:
  12.        1) a sortfile.c module is added that is included if the symbol BESTIO
  13.    is defined. The stdio buffers have been increased to 2K, which seems a
  14.    better choice than the standard 512.
  15.        2) a fastcmp.asm module is added for faster comparision functions;
  16.    these functions are taken from sortcomp.c if M68000 is not defined.
  17.  
  18.    Contents of complete package:
  19.  
  20.       fastcmp.asm    - module containing faster comparision functions
  21.       readme         - this introductory file
  22.       sort.c         - module containing basic sort functions
  23.       sort.doc       - manual page for sort
  24.       sort.prg       - the executable program
  25.       sortcomp.c     - module containing comparision functions
  26.       sortcomp.h     - header for sortcomp module
  27.       sortfile.c     - module containing improved I/O functions
  28.       sortfile.h     - header for sortfile module
  29.       sortmain.c     - main module; argument scanning; general key matching
  30.       sortmain.h     - header for sortmain module
  31.  
  32.    It will probably be distributed in two chucks: one containing .c and .h
  33.    files, readme and sort.doc (submitted to comp.sources.atari.st) and one
  34.    containing sort.prg, readme and sort.doc (s. to comp.binaries.atari.st).
  35.  
  36.    Compiled with Lattice C; first compiler pass with -dBESTIO option, second
  37.    with -r option. Fastcmp.asm was assembled using the GST linker.
  38.  
  39.    This program was the result of a question on the net, asking for a disk
  40.    based sort. It seemed like a nice project (in fact, it was 8-), and I
  41.    hope at least the person who asked it can make some use of it.
  42.  
  43.    For questions, bug reports etc. try
  44.  
  45.       L.J.M. de Wit
  46.       Nachtegaallaan 7
  47.       5731XP Mierlo
  48.       Holland
  49.       E-mail: ..!mcvax!philmds!leo (and various other paths...)
  50.  
  51.    Enjoy! (sort of ...)
  52.  
  53.